home *** CD-ROM | disk | FTP | other *** search
/ Night Owl 6 / Night Owl's Shareware - PDSI-006 - Night Owl Corp (1990).iso / 018a / sharesp2.zip / DICMAN.DOC < prev    next >
Text File  |  1990-02-20  |  15KB  |  364 lines
  1.  
  2.  
  3.  
  4.  
  5.  
  6.  
  7.  
  8.  
  9.  
  10.  
  11.  
  12.  
  13.  
  14.  
  15.  
  16.  
  17.  
  18.  
  19.  
  20.  
  21.  
  22.  
  23.                           Dictionary Manager v1.1
  24.                        Acropolis Software Dictionary
  25.                              Management Utility
  26.                    (C) Copyright 1990, Acropolis Software
  27.  
  28.                              Acropolis Software
  29.                                4620 Hazel Ave.
  30.                             Fair Oaks, CA  95628
  31.  
  32.  
  33.  
  34.  
  35.       THE LEGAL STUFF
  36.  
  37.  
  38.          Dictionary Manager is provided on an "as is" basis without
  39.          warranty of any kind expressed or implied. In no event will
  40.          Acropolis Software be liable to you for any damages, including
  41.          any lost profits, lost savings or other incidental or con-
  42.          sequential damages arising out of the use of or inability to
  43.          use the program, even if Acropolis Software has been advised
  44.          of the possibility of such damages, or for any claim by any
  45.          other party.
  46.  
  47.          Dictionary Manager v1.1 is a utility program for maintaining
  48.          the dictionary file included with Acropolis software products
  49.          which include but are not limited to ShareSpell, PopSpell, and
  50.          Acropolis BBS.  Distribution for any other purpose is not allowed.
  51.  
  52.          Dictionary Manager is copyrighted by Acropolis Software.
  53.  
  54.  
  55.  
  56.  
  57.  
  58.       TABLE OF CONTENTS
  59.  
  60.  
  61.  
  62.  
  63.         Introduction              ......................................  1
  64.  
  65.         File list                 ......................................  1
  66.  
  67.         Installation              ......................................  2
  68.  
  69.         Using Dictionary Manager  ......................................  3
  70.  
  71.         Quick Reference           ......................................  5
  72.  
  73.         Use with BBS software     ......................................  6
  74.                                                                         Page 1
  75.  
  76.  
  77.  
  78.       INTRODUCTION
  79.  
  80.        Dictionary Manager version 1.1 is a utility program for maintaining
  81.        the dictionary file included with Acropolis software products which
  82.        include but are not limited to ShareSpell, PopSpell, and Acropolis
  83.        BBS version 4.22 or higher.
  84.  
  85.        Dictionary Manager allows you to add and delete words from the
  86.        dictionary used with either ShareSpell, PopSpell, or Acropolis
  87.        BBS.
  88.  
  89.  
  90.  
  91.       FILE LIST
  92.  
  93.         Dictionary Manager comes with the following files:
  94.  
  95.  
  96.            DICMAN.EXE         The Dictionary Manager Program.
  97.            DICMAN.DOC         This manual.
  98.            DICMAN11.NEW       New features / bug fix reports.
  99.  
  100.  
  101.         It you give copies of this program away you MUST include all three
  102.         files in their original form.  Distribution with one or more of
  103.         the files missing or altered in anyway is strictly prohibited.
  104.         In addition you should distribute it only with another Acropolis
  105.         Software product that makes use of it.
  106.                                                                         Page 2
  107.  
  108.  
  109.  
  110.       INSTALLATION OF DICTIONARY MANAGER
  111.  
  112.         Installation of Dictionary Manager is simple to perform.  The
  113.         only special consideration is whether you are using a hard disk
  114.         based system or a floppy disk based system.
  115.  
  116.  
  117.  
  118.            With ShareSpell or PopSpell:
  119.  
  120.  
  121.              HARD DISK SYSTEM:
  122.  
  123.              Copy DICMAN.EXE to the directory were you have either
  124.              ShareSpell or PopSpell installed.  If the other program is
  125.              installed properly Dictionary Manager will be able to find
  126.              the dictionary file for you when it is executed.  Proper
  127.              installation only requires that the dictionary file
  128.              ACROP.DIC is in either the directory that Dictionary Manager
  129.              is being executed from or in a directory included in the PATH
  130.              that MSDOS searches for files.
  131.  
  132.  
  133.  
  134.              FLOPPY INSTALLATION:
  135.  
  136.              Copy DICMAN.EXE to the floppy disk that holds the program you
  137.              are using and the ACROP.DIC file.  If you plan on adding a
  138.              large number of word to the dictionary I recommend that you
  139.              place ACROP.DIC on a floppy by itself and add the drive the
  140.              dictionary is to the path with the use of the MSDOS PATH=
  141.              command.
  142.  
  143.  
  144.  
  145.  
  146.            With Acropolis BBS:
  147.  
  148.              Copy DICMAN.EXE to the directory were the BBS.EXE file is
  149.              kept.  There are a few special considerations to account for
  150.              when using Dictionary Manager with Acropolis BBS.  See the
  151.              section "Use with BBS Software" for more information.
  152.                                                                         Page 3
  153.  
  154.  
  155.  
  156.       USING DICTIONARY MANAGER
  157.  
  158.         To use Dictionary Manager execute it by typing DICMAN at the DOS
  159.         prompt.  It will search for the dictionary file and then read in
  160.         all of the user supplied words (those added when using the spell
  161.         checking feature of another program).
  162.  
  163.         The screen is divided into three sections.  On the left of the
  164.         screen are the words that will be in the dictionary.  At first
  165.         this list will contain the words loaded from the dictionary.  It
  166.         may be empty if no words have yet been added to it.  In the middle
  167.         of the screen is the list of available commands in addition input
  168.         widows will appear in this area.  On the right side of the screen
  169.         is the holding list.  The holding list is useful for temporarily
  170.         storing lists of words before adding them to the dictionary or
  171.         completely deleting them.
  172.  
  173.         The most basic command keys are the cursor arrow keys and the
  174.         Spacebar.  They allow you to navigate around the word lists and
  175.         to mark the words to be operated on.
  176.  
  177.         The Left and Right arrow keys allow you to select the currently
  178.         active word list.  Pressing the Left arrow moves you to the
  179.         "Word List" column on the left part of the screen.   The Right
  180.         arrow moves you to the "Holding List" column on the right part of
  181.         the screen.  The currently selected column is indicated by its
  182.         name at the top of the column flashing.  Knowing which list is
  183.         currently selected is important since the other commands operate
  184.         on the current list.
  185.  
  186.         The Up and Down arrow keys allow you to move up and down in the
  187.         words displayed in the currently selected word list.  The high
  188.         lighted word in the center of the list is the current word.
  189.         Pressing the Spacebar will mark the current word.  Marked words
  190.         are indicated by a right pointing triangle to their left.
  191.  
  192.         The commands are:
  193.  
  194.          [A]dd single word
  195.            You will be prompted to enter a word in a window in the middle
  196.            of the screen.  The word you enter will be added to the list
  197.            of words in the currently selected column.  The exception is
  198.            if the word is already present in the list it will not be added.
  199.            Added words will be maintained in alphabetical order.  If you
  200.            decide not to add a word just press [RETURN] and nothing will
  201.            be added.
  202.  
  203.          [M]ark all words
  204.            This will mark all of the words in the currently selected list.
  205.            You will be prompted to confirm the command before the words
  206.            are marked.
  207.  
  208.          [U]nmark all words
  209.            This will unmark all of the words in the currently selected list.
  210.            You will be prompted to confirm the command before the words
  211.            are unmarked.
  212.                                                                         Page 4
  213.  
  214.  
  215.          [L]oad file of words
  216.             You will be asked if you want to unmark the words that are
  217.             marked in the current word list.  A no response will leave
  218.             the words marked.  Yes will unmark all of them.  This allows
  219.             you to distinguish the words that were already in the list
  220.             from the words that are loaded from the file since the newly
  221.             loaded words will be marked as they are loaded.  If the file
  222.             you specify cannot be found you will be prompted again for a
  223.             file name.  If you decide not to load a list of words just
  224.             press the [RETURN] key.  The format for the list of words
  225.             is simple.  One word after another each on its own line.
  226.  
  227.               EXAMPLE:    BOY
  228.                           DOG
  229.                           CAT
  230.  
  231.          [E]xchange marked words
  232.            Moves the marked words in the currently selected list to the
  233.            other list.  You will be prompted to confirm the move before
  234.            it takes place.  A good example for this command is:
  235.            Load a list of words into the Holding list with the [L]oad
  236.            command.  Now scan through the words and use the Spacebar
  237.            to unmark the words you do not wish to include in the
  238.            dictionary.  Use the [E]xchange command to move the still
  239.            marked words to the Word list for inclusion in the dictionary.
  240.  
  241.          [D]elete marked words
  242.            Deletes the marked words from the currently selected list.
  243.            Use this command with caution, once the words are deleted you
  244.            will have to manually re-enter them.  You will be prompted to
  245.            confirm the deletion before it takes place.  Use it when you
  246.            have some words that you've added to the dictionary and decided
  247.            that you no longer want there.
  248.  
  249.          [W]rite words to file
  250.            Write the words from the current list to a disk file.  You will
  251.            be prompted for the name of the file to save the list of words
  252.            to.  If you decide not to save the word list just press the
  253.            [RETURN] key.  With this command and the [L]oad file of words
  254.            command you can easily move your personal words from one version
  255.            of the dictionary to the next by [W]riting the word list from
  256.            the old dictionary and then [L]oading the word list into the
  257.            new dictionary.
  258.  
  259.          [Q]uit and abandon changes
  260.            Quits Dictionary Manager without applying any of the changes
  261.            you have made to the dictionary.  It is a "save out" if you
  262.            think you have mangled the word list beyond all hopes of putting
  263.            it into the condition that you wanted it in.  Example: You
  264.            deleted all of the words.  You will be prompted to confirm the
  265.            operation.
  266.  
  267.          [S]ave Word List & Quit
  268.            This is the normal why of exiting Dictionary Manager.  All of
  269.            the user supplied words will be removed from the dictionary and
  270.            the new list of words in the "Word List" column on the left side
  271.            of the screen will be place into the dictionary.  Only the
  272.            words from the "Word List" will be place in the dictionary
  273.            regardless of whether it is the currently selected list or
  274.            not.
  275.                                                                         Page 5
  276.  
  277.  
  278.  
  279.       QUICK REFERENCE
  280.  
  281.         Left / Right Arrows
  282.           The left and right arrows select which word list is the currently
  283.           selected list.  The left arrow moves to "Word List" and the right
  284.           arrow moves to "Holding List".  The current list is indicated by
  285.           the name at the top of the column flashing.  The list that is
  286.           currently selected affects the operation of the [L]oad, [D]elete,
  287.           [A]dd, [M]ark, [U]nmark, and [E]xchange commands.
  288.  
  289.         Up / Down Arrows
  290.           The up and down arrows let you move through the current list.
  291.  
  292.         [SPACEBAR] mark word
  293.           The word that is highlighted in the current list is marked or
  294.           unmarked.  The right pointing triangle to the left of the word
  295.           indicates that it is marked.
  296.  
  297.         [A]dd Single Word
  298.           Allows you to type in a word manually to add to the currently
  299.           selected list.
  300.  
  301.         [L]oad file of words
  302.           Load a file containing a list of word into the currently selected
  303.           word list.  The file must have a format of one word per line.
  304.  
  305.         [W]rite words to file
  306.           Write the words from the current list to a disk file.
  307.  
  308.         [E]xchange marked words
  309.           Move the marked words from the currently selected list to the
  310.           other list.  If the "Word List" is flashing then the marked words
  311.           from it will be moved to the holding list.  If "Holding List" is
  312.           flashing then the marked words from it will be moved to the other
  313.           list.
  314.  
  315.         [D]elete marked words
  316.           Delete the marked words in the currently selected list.
  317.           *WARNING* once deleted you cannot retrieve the words again without
  318.           manually entering them or recovering them from a file.
  319.  
  320.         [M]ark all words
  321.           Mark all words in the currently selected list.
  322.  
  323.         [U]nmark all words
  324.           Unmark all words in the currently selected list.
  325.  
  326.         [Q]uit and abandon changes
  327.           Quit Dictionary Manager and abandon any changes make to the
  328.           dictionary.
  329.  
  330.         [S]ave Word List & Quit
  331.           Save the words in "Word List" back into the dictionary.  The old
  332.           user created words are removed from the dictionary and replaced
  333.           with the words in that list.
  334.                                                                         Page 6
  335.  
  336.  
  337.  
  338.       USE WITH ACROPOLIS BBS SOFTWARE
  339.  
  340.       Using Dictionary Manager with Acropolis BBS software adds a small
  341.       amount of complexity to the problem of maintaining the dictionary.
  342.       Since the BBS software doesn't allow the direct addition of words
  343.       to the dictionary all of the new words come from a file stored
  344.       with the BBS data files.  So you will be using it mostly to add
  345.       the file ADDLIST.TXT from the DFS directory.  The recommendation
  346.       is to create a batch file to start Dictionary Manager and then
  347.       delete the ADDLIST.TXT file so you do not have the same list of
  348.       words to add again and again.
  349.  
  350.       Create a batch file that looks like the following:
  351.  
  352.         COPY DFS\ADDLIST.TXT ADDLIST.TXT
  353.         DICMAN
  354.         DEL DFS\ADDLIST.TXT
  355.  
  356.       Call it something like ADDDICT.BAT.  That way the dictionary
  357.       addition file created by the BBS will be deleted when you finish
  358.       adding the words.  The reason for copying the addition list file
  359.       is that if you use the [Q]uit and abandon changes option the batch
  360.       file would have deleted your only copy of the file containing the
  361.       words.  Another benefit is that you do not have to type in the path
  362.       as part of the file name when you load the word list in, just type
  363.       ADDLIST.TXT.  It makes life a little simpler.
  364.